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CHAPTER 1 

INTRODUCTION 



Have you ever wanted to take a word procesEing file that 
tias written using WordStar and read it using a DOS-based 
word processor like Apple Wiitec? Or maybe yoa have a 
data file generated by a pascal program that you would 
like to access with an Applesoft program? In both of 
these cases you are faced wltti the difficult and tricky 
task of transferring a file from one operating system to 
another ♦ 

Universal File Conversion will copy standard Apple II 
disk files from any one of the four different operating 
systema available foe the Apple II to another diskette 
that us^s a different operating system, Universal File 
Conversion can also simply copy files between two 
diskettes in the sarne operating system. There are foar 
different operating systems currently in use on the Apple 
II computer; Pascal, DOS 3,3, ProDOS* and CP/PS, Figure 
1,1 shows all the possible directions for moving a file. 
Apple I X 1 f iles r which use SOS , may also be transferred 
with universal File Conver b ion ^ because there is complete 
interchange between SOS diskettes and ProDOS diskettes, 
even though the file and volume structures have minor 
differences, All types of files may be moved, with the 
exception of "bad block" and "directory" files. In 
addition, Universal File conversion can format a disk for 
any of the four opera ti ng sys terns . 
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Rgure 1.1 Files Can Be Moved To and From Any of Four Oper- 
ating Systems 



HARDWARE REQUIREMENTS 

Universal File Coni/etsion cequires an Apple II, Apple ri 
Plus, Apple lie, or Apple lie computer with 64K of memory 
and at least one Disk II drive. Howevecj two at more 
disk drives are recoEiimended to speed copying and avoid an 
excess of disk swapping. 

Standard Apple Disk II formatting is the only type of 
formatting supported. In other wotrds, other types of 
disk drives are not supported . These include 3" 
floppiesir hard disks, RAM dislcs^ and even other 5 1/4 
floppies. This is not a serious limitation if you have 
at least one Disk ll drive, because most modified 
operating systems include software that read and yrite to 
a standard Disk II drive. Simply transfer the file to a 
standard 5 1/4'^' floppy before using Universal File 
Conversion , 

Copy protected diskettes cannot be used with Universal 
File Convec3ion> 
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CONVERTING FILES 

When a text file is being converted. Universal File 
Conversion makes all changes necessary for the target 
operating system. These changes include setting or 
clearing the high bit, adding or removing line feeds , 
adding or removing the two block header for the Pascal 
editor, expanding or generating space compression codes, 
etc , 

If the file is not a text file. Universal File Conversion 
makes no changes, with the following exceptions: it 
reserves space for or removes the address and length of 
binary files or the length of Applesoft and Integer BASIC 
files. 

Universal File Conversion is a powerful and helpful 
utility, but merely ifloving a file from one operating 
system ta another may not be sufficient to begin using 
that file in a different operating environment. For 
example, Universal File Conversion can move BASIC 
programs that are text files ftom one system to another, 
but it will net change an Applesoft totenized program 
into an MBftSiC tokenized ptogrami nor perform other 
similar changes. it will not properly convert raridom 
access files. It will not translate machine language 
programs from one language to another, 

universal File Conversion is not designed to delete files 
or write over existing files. These functions can be 
performed jsing the norinal RENAME and DELETE comnanda 
provided by the operating system in question once files 
have been transferred using Universal File Conversion. 



CHAPTER 2 

USING THE PROGRAM 



BOOTtNG THE DISK 

Universal Fll^ Cofiv^^rsion is self-boating. 5 imply place 
the diskette in tirive 1 (slot 6) and turn on your 
computer. Or type PRi6 if your computer is already up 
and tunning* The Plain Menu should appear on the screen 
in a feu seconds. 



The Universal Pile ConV'SCslon program comes on a disl^ette 
that is in Pascal foririat. It is not copy protected, and 
may be copiea using COPVA on your DOS Mdster Disk or the 
PtoDOS Filer utility. Beyond a reasonable number of 
copies for the buyer's personal use for backing up the 
original ^ copying this program is a violation of the 
copyright laws of the United states and other countries. 



SETTING SLOT. DRIVE. AND SYSTEM TYPE 

Press "N" from the Main Menu to change slot/drive 
assignments. The current assignments are printed at the 
bottom of the screen when the Hain Menu is displayed r atld 
during the assignment process. 

The "-source" slot/drive is where you will put the 
diskette with the existing program. You want to read 
fro* this diskette. 

The "destination" slot/drive is where you will put the 
diskette you want the file transferred to. You want to 
WEit« to this diskette. 

Typing "E" allows you to "exit" oc "escape" from what you 
have been asked to enter > 
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If you select ^SOS/PRODOS" as a system typ$, you will be 
aaked to enter a PATH. pressing HETUftK will ao toma t- 
ically select the pathi>ame of the curreat volume. The 
name designated hete will be used as the default pathname 
when copying files to or from a SOS or ProDOS diskette* 
If copying Erom one ProDOS diskette to another, different 
pathnames can be specified for source and destination. 

VIEWING THE CATALOG OR DfRECTORV 

Type "V" from the Main Menj to look at the catalog or 
directory of a diskette. 

¥ou will be asked to select eithei the soucce or 
destination slot/drive . The prograni will expect the 
diskette in the selected dcive to match the system type 
specified at the bottom of the screen. If the system 
type doesn't match, an error message vilL be displayed, 
Otherwise, the catalog or directory will be displayed. 

Press any key after you hai/e finished reviewing the 
di rectory to return to the previous menu. 

COPYING FILES 

Press "c" from the Kain Menu to copy files. 

The universal File Conversion diskette must be in drive 1 
^slot 6) so that the copy routines can be read in. If 
the program does not find it there when you press "C" , 
you will be asked to put it in. Similarly, when you have 
finished copying files, you will be asked to put the 
Universal File Conversion diskette in drive 1 (slot S) 
before returning to the Main Menu* 

CAUTION; You cannot RENAME or DELETE files using 
Universal File Conversion. If you want a new filename to 
be the same as an old fi l^name on the disk, first rename 
or delete files using standard operating system software, 
then run tinivecsal File ConJtfersion . 

You may press the ESC key to exit the copy procedure and 
return to the Main Menu. 

Enter the £i lename just as you would under the source 
operating system. The name may be changed slightly^ 
depending on the destination operating system. See 
Chcipter 4* 

When the source and/or destination is ProDOS or SOS, the 
pathname used is the pathname assigned when the drive 
parameters were speci fled (using the el command from the 
Main Menu) , 
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FORMAHING ADISK 

Type "F" from the Main Menu to format a disk. You must 
have previously assigned the operating system you want 
f ocmei 1 1 ed to ei ther the source or d^s ti nation dr i ve 
(usually destination}. This assignment ia done using the 
"N" command f com th^ Mai n Menu , 

You will be asked to select the source or destination 
drive for formatting. A blank diskette should be placed 
in the appropriate drive before making this selection. 

If the prog cam finds that the diskette in the se lect ed 
drive is already focfnatted (standard Apple II format) r it 
will ask if you want to erase the existing data. 
Otherwise, it will immediately proceed to format the 
di skette . 

If you view a catalog or directory of a diskette 
formatted by Universal File Conversion, it will be empty. 
If you try to boot the diskette, you will get a brief 
message saying that the diskette has no DOS on it. In 
the case of DOS 3.3, space is reserved for the DOS image 
even though no DOS is written to the diskette, DOS can 
be later written to the diskette using the MASTER CREATE 
program that comes with the disk systein. 



ERROR MESSAGES 



Message 

Disk is wrong DOS 

Drive too fast 
Drive too slow 
Error in Filename 

ERROR = # 

I/O Error 

NO BOOT. DATA 



Meaning 

The disk accessed has the wrong 
operating sys tem type . 



The file name is not acceptable* 
It may have an Illegal char- 
acter * 

System error (should not occur) . 



The program can't find BOOT. DATA 
which is on the Universal File 
Conversion diskette . 



No directory space 
Oh diestination 
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Message 

HO DOS.DATA 

MO PASCAL. DATA 
NO SOS > DATA 

No such disk 

Not enough room on 
destination disk 

Only one wild-caird 
character 

OOPS — HEMORlf 
Path not found 

RUNTIME ERROR 
ERROR NUMBER ° 

UNABl^e TO LOAD 



Meaning 

Tt^e gxoqr.am can't tin6 DOS. DATA, 
which is on the universal File 
Conversion diskette. 

The program can't find 
PASCAL .DATA , which is on the 
Universal File Conversion 
d Lskette . 

The pcogram can't find SOS.DATAr 
which is on the Universal Fiis 
Conversion diskette. 

You don't have a disk drive 
connected to the disk controller 
card for the specifed slot and 
drive. 



More than one &qual sign was 
t/ped in the f ilename . 

System error {should not occur) . 

fhe directory you indicated 
(ProDDS or SOS) does not exist. 

Syst«tL error (should not occur). 



An error occurred loading 
rOHMATTER.CODE either an I/O 
error Oi the prog ram can ' t f ind 
FORMATTER. CODE. 



Write protected 



CHAPTER 3 

DISKEHE ORGANIZATION 



Each operating system divides the diskette into 56B 
sectors of 256 bytes each. The diskette has 35 tracks 
with 16 3ectors per track* This chapter esplains how 
each operating system organizes these physical sectors to 
create a directory and a file structure. 

All operating systems order tracks the same-- namely j 
track is the otjtermast track on the diskette and track 
34 is the innermost track. The ordering of sectors 
within tracks is a different story- 

in an attempt to maximize the speed at which information 
can be transferred to and from the diskette, different 
operating systems order the 16 sectors on each track 
differently. Sector ordering can be a confusing subject, 
so we will spend a little time eKplaining ic. 

The easiest order to understand is what we call the 
physical sector order. This is simply the order in whic:h 
the sectors are placed around the disk. The physical 
position o f each sector may be thought oE as the physical 
order niwiber, although this number is not written down 
anywhere. The physical order number may differ from the 
number in the address field of the sector, vie will call 
the sector number in the address field the sectOK ID 
number. Some older operating systems and some "fast DOS" 
utilities actually change the order of the sector ID 
numbers so that they are different than the physical 
order number. Fortunately, the standard versions of the 
operating systems that Universal File Conversion is 
involved with (DOS 3.3, Pascal, ProoOS, SOS, and CP/M) 
all format diskettes with the physical order and the 
sector ID order the same. However, each operating system 
translates the sec tot ID numbe c to a logical sector 
nuinber, and it is this logical sectoc number which is the 
sector used by the software for disk accesses. 
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Pigure 3.1 shows the relationship between physical (or 
sectoc ID) number and the logical sector numbet tot each 
of the four Dpet a t i ng systems. Note that the sectocs 
ca 1 led out later in F igurea 3*2, 3.6* 3.12, and 3.20 are 
the logical sector numbers for the reference<3 opera ti ng 
systetfi* and not necessari ly the sec tor ID numbers. 
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Figure 3.1 Sector Order Table for All Operoting Systems 



APPLE PASCAL 

The Apple pascal disk is laid out in blocks of two 
sectors each. Each bloclt is 612 bytes long. The first 
six blocks on the disk ace reserved. See Figure 3,2 for 
the layout of the Apple Pascal disk. Blocks 9 and I ace 
reserved for the bootstrap loader. Blocks 2 through 5 
are the reserved for the directory of the disk. The rest 
of the disk, blocks e to 279, is usable for storing 
f i les . 

The Apple Pascal d irectory is' structured as shown in 
Figure 3.3, Because Apple Pascal uses a 16-bih pseudo- 
code, the directory is laid out mostly on word bound- 
aries , 

The Pascal directory has two parts. The first pact is 
the directory header, which consists of 26 bytes. The 
second pact is a list of up to 77 file entries. Each 
file entry also consists of 26 bytes. 
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The directory header is irt the first block of the 
directory, block 2. In the dicectory header, bytes 500 
and 50J are an integer representing the number of the 
first block on the disk {always aero] , Bytes $02 and 503 
ace the integer number of the last block in the directoty 
plus one< Bytes 504 and ?05 represent the type of entry 
for this record ; in this case it is zeto« meaning a 
directory. Bytes $07 thcougih are a string repre- 

senting the volume name, Bytes ?0E and S0F repcesent the 
number of blocks on this disk^ 280. Bytes ^10 and 511 
represent the nuDQber of files currently on this disk- 
Bytes $14 and 515 are the date the disk was created. 
Figure 3.4 shows how the date is encoded. 
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J 3^ 

LAST 



TYPE 



S 



B 



VOLUME NAME 



LT SK 



010 
050 



#FILE TIME 



DATE 



RESERVED ISTART [ END 



TYPE 



LEN 



FILE NAME 



FILE 1 



fBYTE DATE 



FtLE 2 



FILE 3 



070 



JPILE 4 



090 
0A0 

dm 



FILE 5 



FILE e 



FILE 7 



FILE B 



FILE 9 



7017 FfiB 
710 

720 FILE 70 

740 

750 
7£0 

770 FILE 73 

780 

79e 

7A0 FELE 75 

7B0 
7C0 
7D0 

7E0 

7F0 NOT USED 



FILE 69 

FILS 70 
FILE 71 

FILE 72^ 
FILE 73 
FILE 74 

~fTle~~75" 
JfILE 76 

FILE 77 



FIRST = FIHST BLOCK OF DISK 

LAST = LAST BLOCK OF DIRECTORY PLUS I 

TYPE = TYPE OF FILE 

VLEH = LENGTH OF VOLUME NAME 

LT BK = LAST BLOCK OF DISK PLUS 1 

tFILE = NUMBER OF FILES 

START = FIRST BLOCK OF FILE 

END = LAST BLOCK OF FILE PLUS 1 

IBYTE ^ NUMBER OF BYTES IW LAST BLOCK 

LEN = LENGTH OF FILE NAME 



Figure 3 J Pascal Directory 
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Rgure 34 Pascal Date Encoding 



The last four bytes of the ditectoty header, S16 thcough 
$19^ are not used (they extend the directory header to 
the same length as a file entry). 

Now for a file entry. Relative bytes 50^ and S01 of a 
file entry give the starting block number foe the file. 
Bytes $02 and $01 give the ending block plus one foe the 
file. Bytes $04 and $05 give the type of file* The file 
types ace shown in Figure 3.5- Bytes 386 throagh S15 are 
a string giving the name of the file. Bytes S16 and S17 
tell how many bytes in the last block of the file are 
used. Bytes $18 and 519 are the date the file was last 
modified. The modification date has the same format as 
in the header (shown in Figure 3.4). 
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DOS 3 J 

A DOS 3.3 dish is laid out as shown by Figure 3.6. DOS 
3,3 is the only operating system which uses the sector as 
the smallest unit for allocation of a file. Tracks 500* 

and S02 ace reserved for the DOS image if present. 
Track $11 is reserved for the volume table of contents 
and the directory.* The rest of the disk is available 
for storing files. 

The voliime table of coDteots OE VT€C is shown in Figure 
3,7. It is located at track $11 sector $00. Bytes $01 
and $02 are a link to the first sector of the directory. 
The only other information of interest in the VTOC are 
the track bi t maps . 



*DOS refers to its directory as the "catalog," but we 
will use the term "directory" even for DOS, because all 
other operating systems use "directory." 



3-6 Universal File Conversion 

















a 1 1 1 7 1 
» 1 i 1 ^ 1 


1 1 J 1 5 1 ifi 1 7 


lal'^lftfBEClDlElF 

1 1 J 




V 

1 




DOS 


IrtAGE 




2 










1 
J 






— — 




4 










c 










D 










■J 

f 

Q 










If 
Q 








ca 


A 










n 
□ 








b3 


C 








to, 


D 










E 










p 








Z 


1 

1 H 










11 


VTOC 




DIRECTORY 




1 Z 










1 T 
1 J 










1 /t 








< 


A 3 










1 t 
40 








K 


T T 
X i 




















19 










lA 










1 n 

4-0 










IC 










ID 










IE 










IF 










7& 
21 










22 









Rgure 3.6 DOS 3^ Disk Layout 

For each track on the disk, there is a map showing which 
sectors are available for use or are already being used. 
Each track bit map consists oC four bytes, but only the 
fitst two bytes are used in 16-sectgt drives. Figure 3.S 
shows the correspondence of the bits in each byte to the 
sectors on a track. 

The rest of track $11 is reserved for the &OS directory 
(catalog) , which starts at sector and continues onto 

descend! ng sectors if necessary. It is shown in Figure 
3,9, Each sector of the directory has this format. 
Bytes ^Sl and ^32 point to the next sector if there is 
one^ If there ace no more sectors in the directory, then 
both bytes of the pointet are zero. 



Diskette Organization 3-7 








I 


2 


3 


4 


5 


6 


7 


B 


9 


h 


B 


C 


a 


E 


F 


0« 




LINK 


VER 




VOL 





10 

30ATI 
40 
50 
€0 
73 
60 
90 
A0 
B0 
C0 
□ 
E0 
F0 



+ - 



TRACK 2 
TRACK 6 
TRACK A 
TRACK E 
TRACK 12 
TRACK 16 
TRACK lA 
TR^CK IB 
TRACK 22 



TD ST 



ss 



TRACK 3 
TRACK 7 
TRACK B 
TRACK F 
TRACK 13 
TRACK 17 
TRACK IB 
TRACK IF 



TRACK 
TRACK 4 
TRACK B 
TRACK C 
TRACK 10 
TRACK 14 
TRACK la 
TRACK IC 
TRACK 20 



TRACK 1 
TRACK 5 
TRACK 9 
TRACK D 
TRACK 11 
TRACK 15 
TRACK 19 
TRACK ID 
TRACK 21 
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VER = DOS VERSION 
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Figure 3.7 DOS 3.3 Volume Table of Contents (VTOC) 
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Rgure 3.8 DOS 3.3 Bit Map for One 16-5ector Track 



For each file entry, bytes 608 and $01 point to the 
beg inning of the track sector list for that file. Byte 

is th* file type. The file types are shown in Figure 
3,10, The file nam^ occupies bytes $03 thtough S20. 
Bytes $21 and 522 are the length of the file in sectors. 

The format of each sector of the track sector list is 
shoyn in Figure 3.11. Bytes $01 and 602 are a link to 
the neKt sector , if any, of the track sector list. If 
there is no next sector, the pointer bytes ace zero* 
Bytes 505 and $06 are the starting sector number of this 
track sector list, A list of the actual sectors in the 
file starts at 50C. There can be at most 122 sectors of 
a file in each track sector li&t. 
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LINK = LINK TO NEXT SECTOR OF DIRECTORY 

TSP = TRACK SECTOR POINTER 

FT = FILE TYPE 

FL = FILE LENGTH 
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Figure 3,10 DOS 3.3 RIe VP©s 
ProDOS AND SOS 

PcoDOS and SOS are somewhat similar to DOS 3,3 in that 
they both use a bit map to t&ll ijhioh areas of the disk 
are in use . The indeii blocks of ProDOS and SOS could be 
likened to the track sector lists of DOS 3.3 also, but 
here the similairity ends. ProDOS and SOS allow direc- 
tories as files and DOS 3.3 has nothing like that. 

Figure 3,12 shows the layout of a PcoDOS or SOS disk. 
proDOS and SOS jse 512-byte blocks of two sectors each, 
as Apple Pascal does. Blocks and 1 are reserved for 
the bootstrap loader. Blocks 2 through 5 are the volume 
directory of the disk. Block 6 is the bit map for the 
disk* The rest of the disk, blocks 7 through 279, is 
available to store £i les . 
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LINK = T/S OF NEXT T/S LIST SECTOR IF DATA SECTORS 

EXIST HBYONE 79 
OFF = SECTOR OFFSET INTO FILE OF FIRST DATA SECTOR 
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Figure 3.11 DOS 3,3 Track Sector List 



The first block of the wolu«e directory is shown in 
Figure 3,13, The other blocks of the directory are 
similar except that the volume hesdec information is 
replaced by a file entry. Relative bytes $00 and $01 of 
the directory block point to the previous block, if any, 
in the directory. Bytes $02 and ^03 point to the next 
block , if any . 

The first byte of the volume header has two uses. The 
first four bits (high nibble} indicate the storage type, 
in this case for a volume directory header. The 
storage types ace shown in Figure 3.14* 

The last four bits (low nibble} of the the first byte of 
the volume header are the numbet of characters in the 
volume name. Bytes 505 throjgh §13 contain the volume 
[tame. Eight reserved bytes, S14 through SIB, are next. 
Bytes 51C and ?1D are the cceation date. Bytes SlE and 
51F ace the creation time. The encoding for the date and 
time is shown in Figure 3-15- 

Bytes $20 and S21 are for checking version compatibility. 
Byte ?22 is the access byte. The meaning of each bit of 
the access byte is shown in Figure 3.16, 
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Figure 3.1 2 ProDOS/SOS Disk Layout by Block Number 



Byte 323 is the entry length of each entry in this 
dieectory. Byte $24 is the number of entries in each 
blocK o£ the directory. Byte^ $25 and $26 are the number 
of files in the directory. Bytes $27 and $2B are a 
pointer to the volume bit map. Bytes $29 and $2A are the 
total number of blocks in the volume 



Diskette Organization 3-14 



p. PST 



H . PUT it _Nl1 



VOLllME NAME 



VOLOHE HA HE 



JTOA'TE I C.tIHE 



VER MVER ACC EL 



EPBl flLECNTl BITMPHT ] TOTBLK 



49 

50 
60 
70 
BS 
90 
AS 
B0 
C0 
D0 
E0 
F0 
L0( 
111 
121 
13(1 
14G 
ISC 
16( 
17e 
IB 
19( 
1A9 
IB 
ICS 
iQi 

lee 
If I 



"W 



ST NL 



TYPE 



jC-.DflTE |-C.riHE I i/ER 3 HVER^ fiOC| AUXTyPE 



FILE NAHE 



KEY_ PNT 

■m.date 



Ht>NT 



P.PHT 




PHEVIOUS BLOCK OF DlftECTORY 


N.PHT 




N£XT SLOCK OF DIRECTORY 


ST 




STORAGE TYPE 


HL 




WAHS LENGTH 






CREATION DATE 


C.riHE. 




CREATION TIME 


VEH 


■ 








HIHIHUH VERSION 


ACC 


■ 


ACCESS 


SL 




ENTRY LENCTH 


EPB 




ENTRIES PER BLOCK 


FILECNT 




NUMBER OF FILES 


BITHPHT 




POIHTER TO THZ BIT HAP 


TOTBLK 


■ 


NUMBER OF BLaCKS ON QfSK 


TYPE 




TYPE OF FILE 


REy PtJT 


■ 


POINTER TO FILE 






NUHBER OF OLOCKS 114 FILE 




m 


AUXILIARY TYPE 


M.DATE 




MODIFICATION DATE 


H.TIHE 


m 


MODIFICATION TIME 


HPNT 




POINTER TO START OF DIRECTORY 






NDT USED 



Figure 3.13 ProDOS/SOS Directory Header Bfock 
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Rgure 3.14 ProDO5/S05 Storage T/pes 
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Ffgure 3.15 ProDOS/SOS Date and Time Encodfng 
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Hgur© 3.16 ProDOS/sOS Access Byte Flags 



A file entry is almost identical to the volume entry* 
The first byte ot the file entry, is again divided 

into the storage type and the length uf the file nanie. 
The file name is again 15 bytes in length. The bytes 
that w&ce reserved in the volume header take on meaning 
in a file entcy. Byte Bid is the file type. The file 
types are shown in Figure 3,17. 

Bytes 511 and ?12 poinb to the key block of the file. 
Bytes $13 and $14 give the length of the file in blocks. 
Bytes 515 through $17 are the logical length of the file 
in bytes. The cteatioh date and time, version bytes, and 
access type are next as they were in the vol jme header . 
Bytes SlF and $20 are the file's auxiliary type. Bytes 
521 and $22 are the modification date. Bytes $23 and $24 
ace the modification time. Bytes $25 and $26 are the 
"head pointer , " indentif ying the starting block of the 
di rectory . 
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Figure 3.1 7 ProDOS/SOS Ffle lypes 



An e)tample of the ProDOS/SOS bit map is shown in Figure 
3,19* As discussed earlierr the bit map is usually block 
G of the volume in question. One bit of the bit map is 
on lequal to 1) for every block that is "free" for use. 
For a standard diskette, only 2B2 blocks are available* 
Thus, only the first 35 bytes of the bit map are used. 
The cema in ing (irrelevant) bytes are set to zero. For 
hard disks or other volumes that have more than 4096 
blocks^ the bit map carries over into the imjnedlately 
following blocks, 

proDOS and SOS have four different methods of storing 
files. These four methods are subdirectory files, 
seedl ing f iles , sapl i ng f lies f and tree f i les . The 
storage method is dictated by the storage type (see 
Figure 3.14) , Figure 3-19 describes the four storage 
methods . 

Subdirectory files can be any number of blocks in length. 
Each block in the file has pointers which point forward 
and backward to the neitt and previous blocks in the file. 



344 U n iversa I Fi le Conversion 



Blocks SO— J9 In Use BlocksSA— S117FreB 




00 fi03£^fFTFFFFFFFFFE'FrFFFFF> 

0C FFFFFFFFFFFFFFFFFFFFFFE 

le FFFFFFFFFFFFFFFFFFFFFFflfl 

24 Q00Q000000a0000eC](3O00000 

30 Q000i}00900Ef0000Q00000000' 

3C 0000000000000e000i300000d ............ 

(Remainder of Blci{;k Zeroes] 

Rgur6 3.id ProDOS/sos Volume Bft Map* 

'ReprMted wim permission ffom Beneath App*& ProDOS , by Don Worth and Pleter 
Lechner {Quality Software, 19M). 



Seedling files are the easiest to undeirstanid . The 
pointer from the director/ points dicectly to the only 
btocl: of data in the Eile, 

Sapling files have a single index block. Tbe pointec 
fcom the directory points to the irjdex block. The index 
block has 2 56 po in tecs to the actual data blocks of the 
file. The pointers are stoEed in an odd fashion. The 
high byte of the pointer is 256 bytes after the low byte. 
All pointers in the indeJi block that are not needed are 
set to zero, 

Tree files hsve two levels of index blocks _ The index 
block the directory points to is called the master index 
block. It points to 133 more index blocks. The other 
index blocks are j ust like the sapl ing f ile' s i ndex 
block. Again, pointers that are not needed are set to 
zero » 



CP/M 

CP/M uses a very different file structure than the other 
operating systems. It helps to remember that it was 
designed for eight inch floppy disks that had twenty sin 
128-byte sectors pec track. This is very different than 
the Disk ll*s sixteen 256-byte sectors pet track. 

The layout of a CP/M disk is shown in Figure 3,20, CP/M 
uses blocks of 1024 bytes or four sectors, However, 
block zero does not start at track zeto^ sector lero, but 
at track three* sector zero. Tracks 2, 1, and 2 are 
reserved for the CP/M operating systeiii. Blocks S and 1 
are reserved for the directocy. The rest of the disk, 
blocks 2 through 127, is available to store files. 



Diskette Organization 3^5 



Key Block 



SUBDIRECTORY PILE: stocagetype - 5D 

Any BLQClt Last Block 








po in te r 


pointer 




pain tec 


header 




entry 


^ entEies ^ 


entries ^ 



po 1 nt&r 



entty 



SBEDLIHG PILE: storage t/pe = $1 



]tey pointer 




S9 S EOF ^$209 


block 



Data Block 
S12 byt^s long 




SAPLING PILE: stcrage_type ' $2 

5fla~~5a~i ~ 5Fe~sFF| i"^®* block 

indejt l>l&ck I up to 356 2-byt# 

Dintera to data blocks 



data 
block S00 




data 




data 


block $ai 




block $P£ 



key pointer 
$2t99S £ EOF < 




TREE FILE: Btorage_typ« > €3 

Ha star I ndex B lock 



master indent block 



$9a $ai $FE fFP 
in<lex block $0e 



up to 126 2-byte 
pointers Co Irvdev 



datd 
block ^BB 



data 
block 



$90 $ai $FE $PF 
index block ^7F 



data 
blocK $00 



data 
block ^FF 



Rgure 3.19 ProDOS/505 flle Slomge Formats 



3-16 Universal File Conversion 



Diskette Organization 3-17 



SECTOR NUKBER 





B 1 1 1 a 


3 1 


4 1 S 1 « 1 


71 


B 1 9 [ a| 




C 1 D 1 E 


F 





L 

2 


RESERVED 




3 


Dl 


RECTORY 




BLOCK 


2 


BLOCK 


3 




4 


BLOCK 


4 


BLOCK 


S 


BLOCK 


6 


BLOCK 


7 




5 


BLOCK 


d 


BLOCK 


9 


BLOCK 


A 


BLOCK 


B 




6 


BLOCK 


C 


BLOCK 


D 


BLOCK 




BLOCK 






7 


BLOCK 


la 


BLOCK 


11 


BLOCK 


12 


BLOCK 


13 




B 


BLOCK 


14 


BLOCK 


15 


BLOCK 


16 


BLOCK 


17 




9 


BLOCK 


IB 


BLOCK 


19 


BLOCK 


lA 


BLOCK 


IS 




A 


BLOCK 


IC 


BLOCK 


ID 


BLOCK 


IE 


BLOCK 


IF 




B 


BLOCK 


20 


BLOCK 


21 


BLOCK 


22 


BLOCK 


23 


u 


C 


BLOCK 


24 


BLOCK 


25 


BLOCK 


26 


BLOCK 


27 


m 


D 


BLOCK 


2S 


BLOCK 


29 


BLOCK 


2h 


BLOCK 


2B 




E 


BLOCK 


2C 


BLOCK 


2D 


BLOCK 


ZE 


BLOCK 


2F 




r 


BLOCK 


39 


BLOCK 


31 


BLOCK 


32 


BLOCK 


33 




10 


BLOCK 


34 


BLOCK 


35 


BLOCK 


36 


BLOCK 


37 


z 


11 


BLOCK 


33 


BLOCK 


39 


BLOCK 


3A 


BLOCK 


3B 




12 


BLOCK 


3C 


BLOCK 


3D 


BLOCK 


3E 


BLOCK 


3F 




13 


BLOCK 


40 


BLOCK 


41 


BLOCK 


42 


BLOCK 


43 


o 


14 


BLOCK 


44 


BLOCK 


45 


BLOCK 


46 


BLOCK 


4 7 


i5 


BLOCK 


43 


BLOCi; 


43 


BLOCK 


ih 


BLOCK 


4B 




16 


BLOCK 


4C 


SLOCK 


4D 


BLOCK 


4£ 


BLOCK 


4 F 


C£ 


17 


BLOC K 


59 


BLOCK 


^ -L- 


RF fir* If 


52 


BLOCK 


53 


Eh 


IB 


BLOCK 


B4 


BLOCK 


55 


BLOCK 


56 


BLOCK 


S7 




19 


BLOCK 


sa 


BLOCK 


59 


BLOCK 


5A 


BLOCK 


SB 




lA 


BLOCK 


5C 


BLOCK 


5D 


BLOCK 


5E 


BLOCK 


5P 




IB 


BLOCK 


60 


BLOCK 


61 


BLOCK 


62 


BLOCK 


63 




IC 


BLOCK 


64 


BLOCK 


65 


BLOCK 


66 


BLOCK 


67 




ID 


BLOCK 


6B 


BLOCK 


69 


BLOCK 


6A 


BLOCK 


6B 




IE 


BLOCK 


GC 


BLOCK 


&P 


SLOCK 


6E 


BLOCK 


6F 




IF 


BLOCK 


70 


BLOCK 


71 


BLOCK 


72 


BLOCK 


73 




20 


BLOCK 


74 


BLOCK 


75 


BLOCK 


76 


BLOCK 


77 




21 


BLOCK 


78 


BLOCK 


79 


BLOCK 


7A 


BLOCK 


7B 




22 


BLOCK 


7C 


BLOCK 


7D 


BLOCK 


7E 


BLOCK 


?F 
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Rgure 321 CP/M Directory 



The CP/M directory is shown in Figure 3,21. There are 48 
directory entries in the Microsoft implementation of CP/M 
foE the Apple. At least one other implementation of Cp/M 
for the Apple uses 64 d irec tocy entr ies * Byte ?0 of each 
entry is a delete flag. The entry is empty if it equals 
$E5. Bytes 501 through S0S ace the primary part of the 
file name. Bytes $99 through S0B ace the file name's 
eK tens ion. Byte $0C detetnnines which en tent of the file 
is cepresented by this entry, A file may us& as many 
extents (new file enttles in the directory! as necessary 
for its length. Byte SF is the number of l^B-byte 
records in this entry for the file. Bytes $10 thrgugh 
SIF represent up to 16 blocks that the file uses. If ^ny 
ace unused, they are zero. 



CHAPTER 4 

FILE TYPES 



The purpose of this chapter is to describe the different 
types of fil&s that are available in each of the four 
operating systems. The topics we will cover ace; 

1. How Universal File Conversion derives a name for new 
files based on the old filename. 

2, A general eKplanation of how BASIC progranas are 
stored . 

3- Some words about converting binary files. 

4. A description of those file types that are common to 
more than one operating system. 

5, A description of those file types that appear in 
only one operating system^ 

The terim file tyfhss as used in this chapter refers to the 
contents of the file^ not to any spscial format the 
operating system uses to store the data fa Seedling file 
or a Sapling file^, for eicamplej . We are concerned with 
the data as if it were a continuous stceam of bytes, 

NEW FILES 

When assigning the name for a new file. Universal File 
Conversion uses the name of the original file as a 
starting point. The different operating systems have 
different maiximum lengths far a filename* If the old 
f i lename is too long for the new operat i ng system , it is 
truncated. Also* because only DOS 3,3 allows spaces as 
part of the filename, Universal File Conversion wili 
remove spaces when converting to other operating systems. 



4-2 Unlvereal File Conversion 



Periods ate not allowed in CP/M filenames^ so Universal 
File conversion will remove them wheo creating a new CP/M 
fite. Here are some examples: 

Converting from Cp/M to DOS i.3-- 

INVEM.DAT becomes INVBW^DftT 

Converting from DOS 3.3 to CP/H-^ 

INVEN-DAT becomes ENVENDAT 
ItJVEN DATA becomes 1NVENDAT,A 

Universal File Conversion will not allow you to write 
over a file with the same name. If you wish to destco/ 
an existing file and replace it with a new file of the 
same name, you inust first use the operating system 
software to delete the old file^r then use Universal File 
Conversion to write the new one. If you wish to preserve 
the existing Eile with a diffetent name (e.g. FILE.BAK) / 
yoa must first ase the operating system to rename the old 
file, then use Universal File Conversion Co write the new 
one , 



CONVERTING BASIC PROGRAM FILES 

Most BASIC interpreters stote a program in & tokenized 
form. This means that each keyword, such as "PRINT" or 
"INPUT", is replaced by a byte or " tok^n" wh ich repre- 
sents the keyword. Li£e would be simple if each BASIC 
replaced each keyword by the s^me "token" byte, unfor- 
tunately , this i s not the case * 

This means that if you were to move the program in its 
toheniied form from one BASIC to another » it most likely 
would not [flake sense to the second BAS IC, Fof example , 
the token for the PRIHT statement in the first BASIC 
might be the token for the SIN function in the second. 

Fortunately^ there is a way to move BASIC programs. Most 
BASIC interpreters allow you to, optionally, store a 
program as a text £iLe. It is in this form that 
Universal File Conversion will eoccectly move BASIC 
programs around. Note that DOS 3,3 and E^roDOS use the 
game BASIC, namely Applesoft, so you do not have to 
convert to a text file before using Universal File 
Conversion when going back and forth from DOS 3.3 and 
proDOS. This is the only exception. 
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After universal File Conversion has moved che BASIC 
program in text focan, you will probably stilL have to 
make changes . Foe example, Microsoft BASIC tot CP/M has 
a "PRINT USING" statement, but Applesoft does not. You 
would have to change all the ''PRINT USING" statements in 
the program so they make sense to Applesoft. A more 
drastic example is an Applesoft program that uses 
graphics. Such a program would require extensive changes 
to run in a BAJiIC that did not support graphics, 

CONVERTING BINARY FILES 

The intended use of the binary file is to store a machine 
code program. In practice, this is not always the case. 
For example^ it may be used to store the high resolution 
graphics screen, or it could be text used by certain word 
processors, universal File Conversion treats binary 
files as a machine code ptocjram or data — it never treats 
a binary file ais te^ct. 

Note that moving a machine code progtam from CP/H to DOS 
3.3 does not make much sense. The processoc used by CP/M 
is a 3-80 and DOS 3.3 uses a 6502. They are not 
compatible, Generallyj you cannot move a machine code 
prograin from one operating system to another and have it 
make any sense. universal File Conv ersion permits you to 
move the file over, but you are responsible for any 
translation frctfn one language to another. 

COMMON FILE lYPES 

There ace 10 file types that are defined in more than one 
oper a t Ing system on the Apple: text, binary, reloca table 
binary, Applesoft EA5 IC, Integer BAS IC, Pascal code , 
Pascal textf Pascal data, foto, and bad files. The other 
file types are defined in only one operating system. 

Note that Cp/M does not have file types as such. The 
only file type in any way special to CP/M is the ".COM" 
file type. To CP/H, a ".COM" file is an eKecutable 8080 
(or 2-80) machine code program. Any other file to CP/M 
is simply some program's data file. Universal File 
Conversion treats CP/M files with the extensions ".TXT", 
".ASC", ".FOR", ".MAC", ".ASM", and ".BAK" as containing 
text. All other files are treated as binary data. 

Also note that all f i le types used by DOS 3^3 ace defined 
in at least one other operating system. And^ all pascal 
file types but one ate defined in another operating 
system. 
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Figuce 4.1 indicates the type of destination file that 
will be created when a given file type is converted from 
one operating system to another. The destination file 
type depends on what operating system the file is being 
moved CO. If the source file type is not shown in Figare 
4.1, it is treate(3 the eame as a data file. 







DESTINATION 


CP/K 


[>0 S 3 .3 


PASCAL 


ProLKJS/SOS 




TEXT 


TEXT 


TEXT 


PAt TEXT 


TEXT 




PRSCAL TEXT 


TEXT 


TEXT 


PAS TEXT 


TEXT 
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APPK-ESOFT 


DATA 


APPLSrT 


PAS DATA 


APPLSFT 





INTEGER BASIC 


DATA 


INT SAS 


PAS DATA 


INT BAS 
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BIldARy 


DATA 


BINARY 


PAS DATA 


BitJARY 




RBL BINARY 


DATA 


REL BIN 


PftS DATA 


REL BIN 
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FOTO 


DATA 


BINARY 


FOTO 


POTO 
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PASCAL CODE 


DATA 


BINARY 


PAS CODE 


PAS CODE 




PASCAL DATA 


DATA 


BINARY 


PAS DftTA 


PAS DATA 




DATA / OTHER 


DATA 


BINARY 


PAS DATA 


TYPE[.EBE 






N/A 


N/A 


N/A 


N/A 
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NOW we will look at each common file type in detail. 
BAD FILES 

The bad file is the easiest to understand. It ia just a 
file created during EoEnn^tt ing to prevent the use of 
damaged areas on the disk . As such , it is unreadable and 
contains no data. 

TEXT FILES 

The text file, which is used in some form by all of the 
operating systems, is also easy to understand. It 
consists of one or more cecocds* Each record contains 
ASCII-type data and ends with a carriage return. A 
generalized example o£ a text file is shown in Figure 
4.2. 



54 iB 4^ 53 20 49 

41 AE 0D 45 58 41 

4C 45 22 4F 46 0D 

54 45 5a 54 20 46 

45 



53 20 THIS IS 

4D 50 AN.EJiAMP 

41 20 LE OF, A 

45 4C TEXT PIL 



Rgure4.2 Text File Sample 
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Each operating system defines a text file slightly 
differently. For CP/M, the cacriage ceturn is always 
followedi hy a line feed. This is the only diffeeenee in 
CP/M. Foc DOS 3.3, there are two differences. The first 
is that the file is stored with the high bit of each byte 
"on." Second, the file may contain null bytes, also 
called zero bytes, A proDOS or SOS text file may also 
contain null bytes. There ate several differences for a 
pascal text file. First, the first 1024 bytes of the 
file are reserved as [3ata for the Pascal text editor^ 
Second , the rest of the f i le is bcoken into 10 24 -byte 
pi eces , No 1 i ne of tex t may cross the IK boundary. The 
uniised space at the ehd of a IK block is filled with hull 
bytes. Third, the file must be a multiple of IK in 
length. Fourth, each line may start with a space 
compression code. This is a DLE character (5i0J followed 
by a character representing the numbsE of spaces at the 
beginning of the line plus 32 . 

Uni\/ersal File Conversion knows about the differences in 
format between different types of text files, and will do 
all the steps necessary to convert a text file ftom one 
format to another. 

BINARY FILES 

The binary file is a memor y image with two other pi eces 
of information — the address in memory where the image 
belongs, and the length of the image. A memory image is 
simply a copy of a specified portion of the computer's 
memory at the time the file was created. In ProDOS and 
SOS r the address and length information is kept in the 
directory entry for the file. The address is stocedi in 
the "auxiliary type" and the length is stored in the 
"EOF". In DOS 3.3, this information is stored in the 
file itself — the first two bytes of the file being the 
address and the second two being the length. 

universal File Convetsion will add or remove, as 
necessary, the 4-byte header for a DOS 3.3 binary file. 
If it is eidding the 4-byte header, the rnemoty address it 
supplies is the previous address if there was one, 
otherwise it uses $2232, The length it supplies is the 
number of bytes in the file. If the destination 
operating systecn has a place for the 4-byte header, it is 
stored there. If there is no place for the four bytes, 
they are simply discarded. 
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APPLESOFT AND INTEGER BASIC FILES 

The Applesott and Integer BASIC file types are ^ecy 
similac to each othec and to the binary file. These 
files consist of a memoty image of the BASIC program, 
which is tokeniaed. The length of the file is also 
saved> in the same way as for the binary file, PcoDOS 
and SOS store the length of the file in the directory, 
DOS 3.3 stores it in the first two bytes of the file. 

Universal File Conversion will add ar remover as 
necessary, the two-byte length of an Applesoft or Integer 
BASIC file. When moving between ProDOS or SOS and DOS 
3.5* the length information is transferred correctly, 

RELOCATABLE BINARY FILES 

The relocatable binary file Is the output of the DOS 
Toolkit assembler or the ProDOS Toolltit assembler. Its 
format is described in the manuals for those programs. 

Universal File Conversion makes no changes to this type 
of file. 

FOTO FILES 

The foto file is a memory image of the screen, usually 
the high tGsol ution graphics , Because there are several 
different screen modes in both the Apple II and Apple III 
computers, we will not attempt to describe foto files in 
more detai 1 . 

Universal File conversion [nakes no changes to this type 
of file unless it is beir^g moved into DOS 3.3. Then the 
rules for a binary file apply, 

PASCAL DATA FILES 

The Pascal data file is made up of records. Each record 
is a memory image of whatever the user defined the file 
to represent* The pascal operating system does not store 
any information telling how long a record is or what the 
record represents , 

Universal File Conversion makes no change to a Pascal 
data file when moving between Apple Pascal and proDOS (or 
SOSJ. When a Pascal data file is moved into DOS 3.3, the 
rules for a binary file apply. 
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PASCAL CODE FILES 

The Pascal code file takes several forms. Regardless of 
which form the file is in^ the first block {0) of the 
file is a segment dictionary* It contains information on 
up to 16 segments* Each segment begins on a block 
boundary. For a complete discussion of the internals of 
a Pascal code file, see Apple's "Pascal Technical Mote 
#16". 

Universal File Conversion jnaKes no change to a Pascal 
code file when moving between Apple pascal and ProDOS (or 
SOS). When a Pascal code file is moved into DOS 3.3, the 
rules for a binary file apply* 



UNIQUE FILE TYPES 

The rema in ing file types are defined in only one 
operating system. These files generally would not make 
sense if moved to a different operating system. 
Universal rile Conversion makes no changes to any of 
these file types unless the rules for a binary file apply 
{only when the destination is DOS 3,3), 



PASCALONLV FILE TYPES 

The Pascal Graf file is 
U.C.S.D- Pascal* it was 
term inal , 



not used in the Apple. In 
used for a special graphics 



SOSONLY FILE TYPES 

The typeless fi le (S00) is just that. It has no type and 
its format is undefined. 

The foDt file (507) is a special file containing a set of 
characters for the Apple lit. 

The BASIC progcam file (509) is ah Apple III BASIC 
program. It is a tokenized memory image of the prograffl. 

The BASIC data file is a data file made by Apple 

111 BASIC. Its format is up to the user. 

The word processor file {$0B) is not presently jsed , 

The SOS file i$(iC] is a special Apple III system file, 
the formats of which are described in the "SOS Reference 
Manual" . 

The RPS data file [S10) and the HPS indei file ($11) are 
files from Apple til Record processing Services* Their 
formats are described in the manual for HPS- 
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PRODOSONLY FILE TYPES 

The proDOla added comncind file is not used at 

present by ProDOS, 

The ProOOS System file {$FF) is a special Apple ir system 
file, Thi s fonnat is deser ibed in the " ProDOS T&chnic-al 
Reference Manual" . 

The PEODOS AppleWorks files {$19, 5lA, and $1B] are 
designed to wotit with the AppleWocks package and their 
structures are specific to that package. Type 519 is an 
AppleWorks data base file, type 51A is an AppleWorks wotd 
process! file, and typ& 5 IB is an AppleWorks spread- 
sheet file. 

The ProDOS Pascal file (SEP) is not used at present by 
PtODOS, 



CHAPTER 5 

GENERAL PROGRAM FLOW 



This chapter explains in a somewhat general way ho^i the 
Universal File Conversion ptrcgraiQ is laid out. You do 
not have to understand this chapter {or the rest of this 
niamial , Cor that matter) to run Universal File Convert 
aion. This chapter is included to give some Insight to 
those who are curioias to know how the program works and 
to help those who may wan t to mod i f y the pr agr am f or 
their own special use. The test of this chapter assumes 
the reader has some knowledge about progranuning and a 
faBiiliarity with Apple Pascal. 

Universal File Conversion Is org an i zed into several 
modules. It makes extensive use of Apple Pascal's unit 
and segnient facilities to accomplish this. Figure 5.1 
shows the relationship of the different modules of the 
program. There is a unit for each of the four operating 
systems. Each of these units contains ail the coutines 
necessary £or reading and writing files to disks that use 
that operating system. There is also a global unit. The 
global unit contains procedures for things that are 
needed fcir all opera ting systems , such as screen control 
and error messages , 

There are segments for each Main Jlenu function except 
Copy and Quit. There Is also a segment that initializes 
all the global variables of the program. This segment is 
executed only once. There are also some assembly 
language procedures that are linked into the segments and 
units where needed. 
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STABT UFC 




COPY 
FILE (SJ 




ProDOii/SOS 

ROUTI^^ES 



ROUTINES 



jOS 3.3 
ROUTINES 



COHVERT 




PASCAL 
ROUTINES 



Figure 5.1 Overview of UFC Program Struclure 



The program also makes use ot the Heap {Pascal's djfnamic 
variables]! , to store data avalting conveisiori from one 
operating system to another . The H^ap is used because 
the diffecent opecating system uinits use difEetinc) 
anvounbs of memory. This allows as much data as possible 
to be loaded into memory at one time. The Heap is also 
used for storing directories and pointers into those 
directories for each operating system. 



THE INITIALIZE SEGMENT 

When the Universal File Conversion program begins to 
execute, the first thing it does is call the initialize 
segment. This procedure does the following four things; 
it sets all of the pointer variables to NIL, loads the 
screen control characters fcom the *SVSTEM.MISCXNFO file, 
sets the scarce and destination indeires, and sets the 
default system types and drives. 
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THE MAIN MENU 

The program next displays the Main Menu> This procedure 
directly coordinates all functions of Universal File 
Conversion , eatcept for the copyi ng of files , When the 
Menu procedure begins, it loads into memocy all the 
segment procedures for all the command s except copy i ng 
files. When the user wants to copy files, the Menu 
procedure is eitited and all of the segments it loaded 
into memory ace released. 



THE FORMAT PROCEDURE 

The Format procedure beg ins by load i ng several data files 
and the actual disk formatter into memory. The data 
files contain empty directoEies and a bootup program. 
The bootup program will be written to the formatted disk. 
It will be executed when the formatted disk is booted and 
will simply turn the drive off and display a message 
saying that there is no T>QS on the disk. 

The Format procedure asks the user which disk , source or 
destination^ he wants to format. The program then checks 
to see if it can read the disk in the specified drive^ 
If it can, it asks the user if he wants to erase the 
disk. If yes, the progcam then begins to format the 
disk. The formatter does a quick speed checK on the 
sped fied drive before it formats the disk. 

After the formiatter finishes, there is nothing on the 
diskette. The bootup program is then written to track 0, 
sector 0, Then a case statement is used to determine 
which directory must be written on the disk. After this 
is finished, the program asks the user if he wants to 
format another disk by ashing him which disk, if any, he 
wants to format , 



THE VIEW PROCEDURE 

The View procedure is used when the user wants to look at 
a directory. The usee specifies the drive for which he 
wants to V iew the d ir ec tor y, A case st a temen t is used to 
call the appropciate procedure for the operating system 
associated with the specified disk drive. Each operating 
system procedure displays the file names in the directory 
[or catalogj , and then waits for the user to press a key. 
When the user presses the key, he is asked if he wants to 
view another directory or tetarn to the Main Menu. 
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THE HELP PROCEDURE 

Tlie Help procedure displays a help screen menu, from 
which the user can select the particular help screen he 
wants. The program then displays the selected help 
Hcreen, Presising a key fcons a help screen returns to the 
help scce&n menu. 

THE NEWOPT PROCEDURE 

The NEWOPT procedure is used when the user wishes to 
change gperating system types, or disk dcives. It uses 
nested case statements to get the new disic drive 
assignments and operating system types from the user, 

COPYING FILES 

when it is time Lo copy files, a nested case statement is 
used to determine which opecating system units and 
variables need to be loaded into mecnory. It calls 
different procedures which load the correct unit{s) and 
variables. All of these procedures in turn call the 
procedjce that does the actual copying. In this way, 
only those units and variables that are actually needed 
are assigned memory sp^ce. 

When the copying procedure begins, it asks the user for 
the file name(s] be wants to copy. Here the copy 
procedure begins a loop, looking for any file matching 
the given name on the source disk. If it doesn't find 
one, it exits, ending up back at the Main Menu. If a 
file is found, it next looks at the destination dish to 
see if a file of the same name exists. tf so, it asks 
the user foe a new destination name (eitisting files 
cannot be copied over). When it has a name for the file 
that is not already on the destination disk, it copies 
the file, when it has copied the file, it goes back to 
see if another file on the source disk is to be copied, 

OPERATING SYSTEM MODULES 

The above description of copying files is a greatly 
simplified look at the program. It does not include the 
many places the program checks to see that the right disk 
Is in the right dcive before accessing it, or how each of 
the operating system modules tfotk. We will take a look 
at some of the support modules for the Ma in Progcam 
below. 
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Bach operating system module has five procedures that 
control the reading or writing of disks. They are: 
Search Directory, Open for input , Open for output , Read a 
sector, and Write a sector , The four ope rati ng sys tem 
modules are ; PASCALSTUFF, SOSSTUPE^, CPMSTUFF , and 
DOSSTUFF. 

Any procedutSj such as Read a sector, in any opecating 
system is called with the same parameters. This means 
that the procedure must take care of all differences of 
its respective operating system. By doing this, the Main 
Progcam does not heve to know anything about what 
operating system it is using. This also makes it easy to 
add another operating system to the program . 

To read a file using a module, you must first call the 
Search Directory routine. This sets up some pointers for 
the Open for input routine, which is called neitt. 
Finally, you can call the Read a sector routine to read 
the file. The process is similar for writing to a file. 



THE CONVERT PROCEDURE 

The operating system modules take care of the physical 
translation of a file from one operating system to 
another operating system. The Convert assembly language 
procedure takes care of the logical translation. It 
handles shifting the file left or right by two or four 
bytes if necessary, such as to put an address and length 
on a binary file. If the file is a text file, it will 
add or remove line feeds, add or remove Pascal space 
compression codes t and add or remove the Pascal IK 
blocking of text files. Of course, it will not make 
unnecessary changes. 

Another of Convert's duties is to handle any leftover 
part of a file, if the file does not fit into memory all 
at once. Convert does this using two 1-sector buffers 
that are hidden from the Kain Prograin. 



VERIFYING DISKETTE TYPE 

There are many times that Universal File Conversion mjst 
check to see that the correct disk is in the drive. 
Whenever the Universal File Conversion disk itself is 
needed, it first checks to see that it is in the drive. 
The only times the program needs its own disk, aftei: 
initial boot, are at the beginning and end of the copy 
process or when a diskette is to be formatted . 
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As for data (SiskSr two different sets of rules apply 
depending on wliether a single drive copy or a double 
d t i copy is reques ted * If a 2-drive copy is cequested, 
th^ only time the prog rdm checks for format CQmpatibility 
is the first time it accesses the disk. It assunies the 
disks stay put until the copying is complete. Note that 
the program never asks the user to place a disk in a 
dcive when doing so would remove a data disk that is 
needed later. In single drive made, however , the program 
checks to s€e if the correct disk is infitalLed cifter 
evety disk swap. 

How does the program detetmine if the correct diskette is 
in the drive? To find the Universal File Conversion 
disk, it looks at the directory to see that the disk is 
called "UFC:". For a data disk, the program only checks 
to see that the disk has the proper type of directory for 
the opecating system it expects . This does not neces- 
sariiy prevent the wrong disk fr&m, being used, but it 
greatly reduces the chance of it happen i n^ . 
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ORDERING THE SOURCE CODE 



For those usees who desire to examine the source code to 
universal File Cooversion, ot attempt to modify the 
program for special applicationsr an annotated listing of 
the source code is available directly fcoin Quality 
5o£twa£e. T w o oc pot ate p a u 4i t i y ii a a r c a ' ^milablo i 

j;^ JDh e — ^AHftt«d— af*n»t^frt* d lis t i f i g s ^ and 

2. A diskette containing the source files- 

Most of uniyersal File Conversion was written in Pascal, 
and therefore the source is primarily in Pascal, 
Substantial portions of the prograjn are written in 
assembly language, however. To properly use the source 
files on diskette requires the Apple Pascal system 
version 1.2 {including the Apple Pascal asserabler) . 

To order -t-lw— li#tii*^-»*i4/&jr the source files on 
diskette* you must mail the coupon on the following page 
t«ne-*-or-&aeh ptodi*efe o-rder-ed} directly to Quality 
Software along with a payment of 510.00 f** — e ach- pr^ l uo t 
9f^-ef«d plus shipping and handling charges*. your 
payment can be a check or bank draft in US dollars, or 
your VISA or WflSTEHCARD number and expiration date. 
California residents must add the appropriate sales tan 
(6 or 6.S%). Wo phone orders or CODs will be accepted. 



Send your or<3er to: 



Quality Software 
21691 Marilla Street 
Chatsworth, CA 91311 



* Shipping and handling charges are (per order)? 

Uni ted States , Canada , Hex ice. 2, 50 
All other countries [leisured air ma il] . . . S10 . 30 



COUPON FOR ORDERING SOURCE ©ODE LISTING 
TO UNIVERSAL FILE CONVERSION 

^ase cut this coupon out of theymanual and mail it (not 
3 ci>SHy) to Qual i ty Sof twar e , 

please SE*n^ me ; 

The "I 





Check 4 

OR VISA/MASTERC 



Street j^^dress 



Ci tyj/state. Postal Code 
CQ4^ntry 



COUPON FOR ORDERING SOURCE CODE DISKETTE 
TO UNIVERSAL FILE CONVERSION 

Please cut this page out of the manual and itiail it (not a 
copy) to Quality Software. 

Please send mer 

A diskette containing the source code 510.00 
(CA Residents) Sales Tas 

Shipping and handling* 

TOTAL 

Check 

OK VISA/MASTEHCARD i EKp 



Name 



Street Address 



City* State, Postal Code 



